Gửi tin nhắn bắt đầu phiên
Đây là một loại tin nhắn đặc biệt để phục vụ cho việc khởi tạo phiên trong đoạn hội thoại.
HTTP request
POST https://{app_id}.api.piscale.com/chat-bot/v1.0/messages
Request body
Ví dụ
{
"thread_id": "",
"ext_user_ids": ["6872016393206779"],
"user_ids": [],
"body": {
"text": "Bắt đầu phiên",
"metadata": [
{
"type": "start_session"
}
]
}
}
Tên | Kiểu dữ liệu | Mô tả | Bắt buộc |
---|---|---|---|
thread_id | string | Mã cuộc hội thoại | ✗ |
ext_user_ids | array | Danh sách ext_user_id | ✗ |
user_ids | array | Danh sách user_id | ✗ |
body.text | string | Nội dung văn bản | ✓ |
body.metadata | array | Danh sách hình ảnh | ✓ |
note
- Bắt buộc
thread_id
hoặcext_user_ids
hoặcuser_ids
phải có dữ liệu. - Đích đến của tin nhắn sẽ được ưu tiên theo thứ tự
thread_id
,ext_user_ids
,user_ids
. ext_user_ids
tối đa 1000 phần tử.user_ids
tối đa 100 phần tử.
Giải thích các thuộc tính của metadata:
Tên | Kiểu dữ liệu | Mô tả | Bắt buộc |
---|---|---|---|
type | string | Phải là start_session | ✓ |
Response
Nếu thành công, bạn sẽ nhận được phản hồi.
Ví dụ
{
"message_code": "M200",
"message": "Success"
}
Tên | Kiểu dữ liệu | Mô tả |
---|---|---|
message_code | string | Mã thông điệp. Xem chi tiết |
message | string | Nội dung mã thông điệp |